Summary

This PR adds new return types for curl_getinfo() for new CURLINFO_* constants that were added in recent PHP 8.x versions. It also corrects the return types of some existing options that were incorrect.

I have also added the appropriate tests for all new constants and adjusted the existing ones.

Details

Changed Types

• 🛠️ CURLINFO_REDIRECT_URL: Returns a string if CURLOPT_FOLLOWLOCATION is disabled, false otherwise.
• 🛠️ CURLINFO_SIZE_UPLOAD, CURLINFO_SIZE_DOWNLOAD, CURLINFO_SPEED_DOWNLOAD, CURLINFO_SPEED_UPLOAD: Returns an integer.
• 🛠️ CURLINFO_PRIVATE: PHP treats this like a classic variable.³ I tested null|bool|int|float|string|array|object|resource.⁴
• 🆕 CURLINFO_HTTP_CODE: (Legacy) alias of CURLINFO_RESPONSE_CODE as of PHP 5.5 and cURL 7.10.8.
• 🛠️ CURLINFO_SSL_ENGINES, CURLINFO_COOKIELIST: Returns a list (instead of an indexed array).
• 🛠️ CURLINFO_CERTINFO: Returns a list of associative arrays (instead of an indexed array).
• 🛠️ CURLINFO_RTSP_SESSION_ID: Returns a string.⁵⁶ Returns false if no ID was set or if the protocol is not rtsp://.
• 🛠️ CURLINFO_PROTOCOL: Returns an integer, a CURLPROTO_* constant value: $\{{-1}, 2^0, 2^1, 2^2, \dots, 2^{27}, 2^{28}\}$.

Added Types (PHP 8.2)

• 🆕 CURLINFO_EFFECTIVE_METHOD: Returns a string.
• 🆕 CURLINFO_PROXY_ERROR: Returns an integer, a CURLPX_* constant value: $\{0, 1, \dots, 32, 33\}$.
• 🆕 CURLINFO_REFERER: Returns a string if CURLOPT_FOLLOWLOCATION and CURLOPT_AUTOREFERER are enabled, false otherwise.
• 🆕 CURLINFO_RETRY_AFTER: Returns an integer (number of seconds, even if the Retry-After header is a timestamp string).

Added Types (PHP 8.3)

• 🆕 CURLINFO_CAINFO: Returns a string for the CA file path or false if it is not set.
• 🆕 CURLINFO_CAPATH: Returns a string for the CA directory or false if it is not set.

Added Types (PHP 8.4)

• 🆕 CURLINFO_POSTTRANSFER_TIME_T: Returns an integer. Since cURL v8.10.0, false otherwise.

Added Types (PHP 8.5)

• 🆕 CURLINFO_QUEUE_TIME_T: Returns an integer. Since cURL v8.6.0, false otherwise.
• 🆕 CURLINFO_USED_PROXY: Returns an integer, resprenting no/yes: $\{0, 1\}$. Since cURL v8.7.0, false otherwise.
• 🆕 CURLINFO_HTTPAUTH_USED: Returns an integer (a CURLAUTH_* constant value). Since cURL v8.12.0, false otherwise.
• 🆕 CURLINFO_PROXYAUTH_USED: Returns an integer (a CURLAUTH_* constant value). Since cURL v8.12.0, false otherwise.
• 🆕 CURLINFO_CONN_ID: Returns an integer. Since cURL v8.2.0, false otherwise.

Sources

PHP Manual:

• https://www.php.net/manual/en/curl.constants.php#constant.curl-getinfo.constants
• https://www.php.net/manual/en/function.curl-getinfo.php

cURL Documentation

• https://curl.se/libcurl/c/curl_easy_getinfo.html
• https://curl.se/libcurl/c/symbols-in-versions.html

PHP.Watch

• https://php.watch/codex?search=CURLINFO_

GitHub Repos

• curl/curl:
  • /include/curl/curl.h#L2904-L3000
  • /lib/vtls/openssl.c#L390-L624
• php/php-src:
  • /ext/curl/interface.c#L2476-L2638
  • /ext/curl/interface.c#L2641-L2732
• JetBrains/phpstorm-stubs:
  • /blob/master/curl/curl_d.php